Getting Started

IBM Notes/Domino 9.0 Social Edition is supported OpenSocial components so that we can integrate more business applications by using OpenSocial Gadgets.
Also, we can integrate application inside to email by using OpenSocial technologies as an Embedded Experience Mail.
This document is described how to use OpenSocial Gadgets in IBM Notes. And, It will be required if you want to use Embedded Experience Mail.

Detail of OpenSocial in IBM Notes/Domino is:http://www-10.lotus.com/ldd/dominowiki.nsf/dx/IBM_Domino_9.0_Social_Edition_OpenSocial_Deployment_Cookbook

Required Components

If you want to use OpenSoical Gadgets in IBM Notes, those components and applications will be required.

IBM Domino (Server)
- OpenSocial Components
(*) You have to install OpenSocial components separately from IBM Domino installation modules.
- Widgets Catalog Application (NSF)
- OAuth Token Store (NSF)

IBM Notes (Client)
- OpenSocial Components
(*) You can install OpenSocial Components from IBM Notes installation modules.

Creating OAuth Token Store application

OAuth Token Store will store information of authentication, authorization and proxy. And, those information will be required when running OpenSocial Gadgets in IBM Notes.
In order to create an application, you have to use console commands of IBM Domino. You can NOT create an application by manually.

1. Creating a NEK (Named Encryption Key).
Execute following command on IBM Domino console.

keymgmt create nek e.g.) keymgmt create nek NotesCons



2. Creating an application by using created NEK
Execute following command on IBM Domino console.

keymgmt create credstore



OAuth Token Store application will be generate automatically under Data\IBM_CredStore directory.

3. Configure an OAuth Token Store application
Open ACL and add [Admin] role to Administrator user. Then, open application and go to "Configuration" view.
Click "Create Encryption Key" button to generate an encryption key.

Creating Widgets Catalog application

1. Create a Widget Catalog application from "Widget Catalog(9)" (toolbox.ntf) template. This application must be created on IBM Domino.



2. Open ACL and add [Admin] role to Administrator user.

3. Enable Agent
Enable all scheduled Agents except (ToolSweeper) agent.


4. Association with OAuth Token Store application
Open Widget Catalog application, then go to "Admin" -> "Configuration". Then, click "Configure Credential Store" button and input information of OAuth Token Store application.「


(Option) You can set Widget Catalog application as a XPages application when opening it from IBM Notes.

Create Account Document

You will need SSO setting between IBM Notes OpenSocial components and IBM Domino OpenSocial components.
So, you have to create a new Account document.

Open Domino Directory(names.nsf), then go to "Policies" -> "Account". And click "Add Account" button to create an account document.

Type following values
Account server name: http:///fiesta/container
Domino Sigle-Sign On server:


Go to "Advanced" tab and input following values
Item - PreferredUsernameField
Value - fullname

Creating Policies

You have to create a new policy then assign both Desktop policy and Security policy.

Creating Desktop Policy

Create a new Desktop policy, then go to Widgets tab.
Type following values:

Widgets catalog server: Widgets catalog application name: File name of your Widget Catalog application (e.g. toolbox.nsf)
Widget catalog categories to install: All (Any values are OK)
Gadget Server URL - http:///fiesta

Others...


Go to "Accounts" tab and add account create previous step


Go to "Custom Setting", then open "Notes.ini tab.
Add following value after clicking "Edit List" button.

ENABLE_EE = 1

Creating Security Policy

Go to "Execution Control List" tab, then click "Edit" button.
Add administrator user and check "Ability to configure Widget capabilities" property.



Go to "Proxies" tab, then click "Edit list..." button and input following values.


Context: xsp/proxy/BasicProxy
URL: http:// Action: GET,POST
Cookies: DomAuthSessId,LtpaToken,LtpaToken2
Mime-type and Headers: *

Register OpenSocial Gadgets

Click "Getting Started with Widgets..." button from Toobar of IBM Notes



Choose "OpenSocial Gadgets"


Input URL of OpenSocial Gadgets xml file after choosing "Add an OpenSocial Gadget by URL".

e.g.) Create helloEE1.xml file with following contents, then copy it to Domino\Data\domino\html. You can access to created OpenSocial Gadget by http:///helloEE1.xml

<?xml version="1.0" encoding="UTF-8"?> <Module> <ModulePrefs title="hello world example"> <Require feature="embedded-experiences" /> </ModulePrefs> <Content type="html"> <![CDATA[ <H1> Hello World! </H1> <iframe src="http://collaborationtoday.info" height=300 width=300> Please use iframe supported Web browser! </iframe> ]]> </Content> </Module>

After completed widgets creation wizard, you can see creates OpenSocial Gadgets in My Widgets side-bar application.

Approve OpenSocial Gadgets

Registered OpenSocial Gadgets can not run on IBM Notes without administrator's approval.
In order to approve the OpenSocial Widgets, administrator approve OpenSocial Widgets on Widget Catalog application.

Before approving the OpenSocial Widgets, you have to register created widget to Widget Catalog application.
Right click on registered OpenSocial Gadgets from My Widgets side-bar application, then execute "Publich to Catalog"

Input required information to Widget registration form. Please make sure input value of "Category" such as All.


After registration, open created document of registered OpenSocial Gadgets. Please make sure you have to use Widget Catalog application on IBM Domino, not a Local.

Then, go to "Admin" -> "All Widgets by Approval" view on Widget Catalog application. You will see created document under "Needs Review" category.


Open the document and change to Edit mode. Then, click to "Review" button.
You will see "Approve" button in the document.


Click "Approve" button.

Click "OK" button on "Configure Proxy" dialog box.



OpenSocial Gadgets approval process has been done. Execute created OpenSocial Gadgets after replicating Widget Catalog application.
You will see OpenSocia Gadgets in your IBM Note.